home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / UTILS / ALPHA / DOCS / SHOWER.DOC < prev   
Encoding:
Text File  |  1995-02-11  |  10.0 KB  |  275 lines
  1.  
  2.                                                  11 February 1995
  3.  
  4.  
  5.  
  6.  
  7.                      SHOWER - The pictureviewer
  8.                   
  9.                             written by
  10.         
  11.                         Blade of New Core
  12.  
  13.                            version 1.0
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20. WHAT IS SHOWER?
  21. ---------------
  22.  
  23. Shower is a simple, fast and easy to use Pictureviewer. It supports
  24. 18 different fileformats (12 if you count all the six Degas-formats
  25. as one) including popular formats as GIF, IFF and IMG.
  26.  
  27.  
  28. LEGAL STUFF
  29. -----------
  30.  
  31. Shower is freeware. You may spread it as much as you want as long as
  32. this textfile is included with the program. The entire program except
  33. for the GIF-depacker is written by Blade of New Core. The GIF-depacker
  34. is taken from Sascha Springer's TurboGIF and is copyright Sascha Springer.
  35. I didn't ask Sascha for permission to use his routine in Shower, but
  36. hope (and think) that he doesn't mind. New Core takes no responsibility
  37. whatsoever for this product, you are entirely on your own if you intend
  38. to use it. However, we have taken precautions in order to make it as 
  39. reliable, stable and harmless as possible and find it really hard to
  40. belive that this piece of software would be able to destroy or mess
  41. something up.
  42.  
  43.  
  44. HARDWARE REQUIREMENTS
  45. ---------------------
  46.  
  47. Shower needs a Falcon 030 to run. It works on both RGB and VGA-monitors.
  48. It should work without problems on accelerated Falcons, but will probably
  49. get problems with graphics-cards. Resolution enhancers like Blow Up should
  50. work without a problem though.
  51.  
  52.  
  53. HOW TO USE SHOWER
  54. -----------------
  55.  
  56. Place the icon for Shower on your desktop and drag the picturefile you want
  57. to view to it and drop it. Shower will now be started and the picturefile
  58. loaded. If something goes wrong (not enough memory, corrupt picturefile,
  59. unsuported fileformat etc.) Shower will (hopefully) quit back to the
  60. desktop. If everything goes ok you will see the picture within som seconds
  61. (or fractions of a second if its a small picture). If the picture is bigger
  62. than the screen you can scroll around it using the mouse or cursor-keys.
  63. Press left mousebutton to change resolution. A press on the right mouse-
  64. button quits Shower.
  65.  
  66.  
  67. FUNCTIONS
  68. ---------
  69.  
  70. Scroll around
  71. -------------
  72. Using the Cursor Keys or by moving the Mouse you can scroll around the 
  73. picture if it is larger than the screen. You can't scroll around
  74. properly when displaying 2-color pictures, since the Falcon-hardware
  75. can't hardwarescroll properly in this resolution.
  76.  
  77. Change resolution
  78. -----------------
  79. With + and - on the numeric keypad you can change the resolution between
  80. low- and hires. A press on the left mousekey will do the same.
  81. You can't switch to hires if the picture is displayed in True-Color-Mode
  82. and you are using a VGA-monitor.
  83.  
  84. Colormode/Black & White
  85. -----------------------
  86. Use F1 to switch between color and B/W-display. Does not work in True Color.
  87.  
  88. Bordercolor
  89. -----------
  90. If the picture is smaller than 640x480 you will get a border around it.
  91. This border is normally drawn in the darkest color found in the palette
  92. (normally black). By pressing F2 you can switch between a dark or bright
  93. border.
  94.  
  95. Binary Dump
  96. -----------
  97. By pressing Control + Alternate + F10 you will save down a binary dump
  98. of the picture. The picturedata will be called SAVEDPIC.BIN and placed
  99. in the current directory (either Top Window or the directory of Shower,
  100. depending on desktop settings). A file called SAVEDPIC.PAL is also created
  101. and contains a binary dump of the palette (from address $ffff9800).
  102. Finally a file called SAVEDPIC.TXT is created that describes the binary
  103. dump (X-resolution, Y-resolution and amount of colors).
  104.  
  105.  
  106. SUPPORTED FILEFORMATS
  107. ---------------------
  108.  
  109. Shower supports the following fileformats:
  110.  
  111. .ART        Art Director
  112. .BMP        PC-Bitmap (still buggy and only 256-color pictures)
  113. .DOO/.MUR    Doodle/Object Editor Mural (same fileformat)
  114. .GIF        Compuserve Graphics Interchange Format
  115. .IFF        IFF
  116. .IMG        GEM Bit Image (including XIMG)
  117. .MAC/.MPT    MacPaint
  118. .NEO        Neochrome
  119. .PC1        Degas Low-res compressed
  120. .PC2        Degas Mid-res compressed
  121. .PC3        Degas Hi-res compressed
  122. .PI1        Degas Low-res
  123. .PI2        Degas Mid-res
  124. .PI3        Degas Hi-res
  125. .PI9        Extended Degas (320*240 in 256 colors)
  126. .RAG        RAG-D!
  127. .RAW        Persistence of Vision (POV) Raytracer output.
  128. .TRU            IndyPaint (only pictures with "Indy"-header, no blocks)
  129.  
  130.  
  131. WHY USE SHOWER AND NOT GEM-VIEW?
  132. --------------------------------
  133.  
  134. Well, there are many reasons:
  135.  
  136. 1. Gem-View requires registration if you really want to use. Shower is
  137.    public domain.
  138.    
  139. 2. Gem-View is a slow program, it takes ages for it to display a picture.
  140.    Shower is a very fast program, written entirely in assembly.
  141.    
  142. 3. Gem-View displays the picture in a window in the resolution it was
  143.    started in (nice if you have a good graphics card, though). Shower
  144.    finds out what resolution is needed to display the picture correctly
  145.    and switches to that and you don't have some stupid desktop-background
  146.    and windows disturbing you.
  147.  
  148. 4. Gem-View have loads of features that normally aren't used and thus
  149.    only takes a lot of memory that could be used for something else.
  150.  
  151. 5. If you want to save down your pictures for use in your own programs
  152.    it can easily be done with Shower since it can create a binary dump
  153.    of the picture and palette (without any headers or packing) that
  154.    easily can be included in your own program.
  155.  
  156.  
  157. WHY USE SHOWER AND NOT TURBOGIF?
  158. --------------------------------
  159.  
  160. Well if your picturelibrary only consists of GIF-files and you are using
  161. Turbogif, you're probably only interested in knowing what Shower's 
  162. advantages over Turbogif are, so here they come:
  163.  
  164. 1. Turbogif is very buggy, it freezes my computer about every fifth time
  165.    I use it. This have never happened with Shower (unless I have loaded
  166.    a corrupt picturefile).
  167.  
  168. 2. Turbogif needs about 3 MEGs of free memory in order to run, independently
  169.    of the size of the picture you want to watch. This is because it uses
  170.    fixed buffers for its operations. Shower dynamically allocates the
  171.    amount of memory it needs.
  172.    
  173. 3. Turbogif is limited to a fixed maximum size when it comes to pictures.
  174.    Pictures bigger than 1280 x 960 might crash the computer. I haven't
  175.    been able to test Shower with such big pictures, but it should work
  176.    with pictures of almost unlimited size (available memory is the only
  177.    limit). Even when watching a picture of a greater size than 1280 x 960
  178.    it shouldn't take the 3 MEGs that Turbogif requires since Shower uses
  179.    its memorybuffers more efficiently.
  180.      
  181. 4. Shower is a bit faster (up to 2 seconds on the biggest GIF-file I have),
  182.    since I use a faster chunkypixel > bitplane-conversion-routine. Still
  183.    some people might find Shower to be a bit slower since it doesn't
  184.    display the picture until its totally drawn.
  185.  
  186. 5. Shower can view the picture in both hi-res and low-res.
  187.  
  188. 6. Shower is a bit less bugy, I managed to display a picture with Shower
  189.    that Turbogif messed up a bit.
  190.  
  191. 7. Shower works both on VGA & RGB (PAL & NTSC).
  192.  
  193. 8. TurboGif can't be started from 4-colormodes or ST-compatibility-modes.   
  194.  
  195. 9. Shower is not limited to GIF-files.   
  196.    
  197.  
  198. WHY THIS STUPID NAME?
  199. ---------------------
  200.  
  201. By simply combining normal Swedish gramatical rules with English words,
  202. you get that a utility for showing a picture is a "Picture Shower".
  203. This is pure, simple gramatics. Don't blame me because the Englishspeaking
  204. population on this earth can't keep their gramatics straight!
  205. This is why I call this program "Shower" and not "Viewer".
  206.  
  207.  
  208. KNOWN BUGS
  209. ----------
  210.  
  211. - Shower doesn't display BMP-files correctly all the time. The colors in
  212.   the palette are mixed up and I still can only display 256-color BMP's.
  213.   I need more information about the BMP-format in order to fix this.
  214.   
  215. - No support for IMG-files with "STTT"-palette since I haven't found an
  216.   IMG-file with this feature yet and been able to test it out.
  217.   
  218. - The sidescrolling of a 2-color picture doesn't work properly, this since
  219.   it isn't possible for the Falcon to hardwarescroll a 2-color picture
  220.   correctly. I'm planning to patch this by using a second screen in
  221.   2-color mode in the future.
  222.   
  223. - I guess there are some extensions to the IFF-format that I still don't
  224.   support.
  225.  
  226.  
  227. HOW TO SUPPORT DEVELOPMENT OF THIS PRODUCT:
  228. -------------------------------------------
  229.  
  230. You can support the further development of this product by writing me
  231. and tell me what you thought about Shower. Tell me about all (if any)
  232. bugs you have found and what you would like me to include. If you have
  233. any information about an unsuported fileformat you can always send it
  234. to me along with some examplefiles and I might include it in a future
  235. version. Don't bother to send me docs about TGA, TNY, SPC, SPU, SPC or
  236. any other fileformat that I probably already have. Don't send me any
  237. info about JPEG either, I won't write my own JPEG-depacker (but might
  238. use Brainstorms decoder if I can get hold of the needed documentation).
  239. If you have any well-detailed info about TIFF, PCX or BMP then please
  240. send it to me. I really would like to include these formats.
  241.   
  242.  
  243. THANKS AND GREETINGS:
  244. ---------------------
  245.  
  246.  Dead Hackers Society (thanks for the betatesting)
  247.  Håkan Bratt (Sysop at Toxic BBS, containing New Core & UDS supportareas)
  248.  All other members of New Core (Lightlord, Shrimp, Marko & The Gambler)
  249.  All my friends at Unique Development Sweden
  250.  Exellence In Art
  251.  Zeal
  252.  TSCC (thanks for all the letters!)
  253.  Lazer
  254.  Code of TBL (the creator of Octalyser STE)
  255.  Lance (anything going on nowadays?)
  256.  Techwave of ICE (are you still coding?)
  257.  Dune
  258.  Impact Software (good luck with your game)
  259.  Aggression (the same to you...)
  260.  CGD ST in Hungary (Hi Daniel!)
  261.  
  262.  
  263. HOW TO CONTACT THE AUTHOR
  264. -------------------------
  265.  
  266.      Tord Jansson
  267.      Skäggetorp Centrum 8
  268.      582 38  LINKÖPING
  269.      SWEDEN
  270.  
  271.    Phone:    +46-13-179123
  272.    E-mail:   tord.jansson@pointless.ct.se
  273.    FidoNet:  2:204/428.16
  274.  
  275.